home *** CD-ROM | disk | FTP | other *** search
/ Hot Metal Pro 4.0 / Hot Metal Pro 4.0.iso / Special / text / odma.txt < prev    next >
Encoding:
Text File  |  1997-11-17  |  4.9 KB  |  173 lines
  1.  
  2. 14. Accessing ODMA-compliant DMSs 
  3.  
  4.  
  5.  
  6.  ODMA (Open Document Management API) is a standardized,
  7. high-level interface between desktop applications and
  8. document management systems (DMS). HoTMetaL PRO can
  9. access an ODMA-compliant DMS. 
  10.  
  11. 14.1. System requirements
  12.  
  13. If the ODMA functionality is to be used, you must supply
  14. a suitable library, and identify it via the Windows
  15. registry in an ODMA32 entry. 
  16.  
  17.  The DLL must provide the OLE interface CODMDocMan to
  18. the standard ODMA functions such as OpenDoc() and CloseDoc(),
  19. as documented (rather briefly in the case of the OLE
  20. interface) at http://www.aiim.org/odma/odma.htm.
  21.  
  22. 14.2. Configuring HoTMetaL PRO to work with ODMA
  23.  
  24. To enable ODMA:
  25.  
  26. * Choose Options... from the Tools menu.
  27.  
  28. * Click on the General tab.
  29.  
  30. * Turn on Enable ODMA.
  31.  
  32. * Click on [OK].
  33.  
  34. * Restart HoTMetaL PRO.
  35.  
  36. Some other ODMA settings are made by editing the HoTMetaL
  37. PRO configuration file, hmpro4.iniin the HoTMetaL PRO
  38. folder with a text editor. Many of these options are
  39. commented out in the configuration file: you must remove
  40. the initial `#' to make them active. After you edit
  41. and save the file, you must quit and relaunch HoTMetaL
  42. PRO in order for the changes to take effect. (Note that
  43. you can use either a colon `:' or an equals sign `='
  44. to set configuration options.)
  45.  
  46. NOTE: Enabling ODMA puts the `access_dms_files = true'
  47. setting in the configuration file.
  48.  
  49. 14.3. Menu items for DMS access
  50.  
  51. If DMS access is turned on, new menu items are added
  52. to the File menu.
  53.  
  54. 14.3.1. Activate 
  55.  
  56. A new menu item called Activate [server] will be added
  57. to the File menu. Choose this command to launch your
  58. DMS. The [server] part of the menu item name is configurable
  59. and gets its value from the server_name_for_activate_menu_item
  60. option in the configuration file.
  61.  
  62. For example:
  63.  
  64. server_name_for_activate_menu_itemá=áNeuraláLace
  65.  
  66.  
  67. would cause the menu item to appear as Activate Neural
  68. Lace.
  69.  
  70. 14.3.2. Open, Save, etc.
  71.  
  72. If you have enabled access to a DMS, you can configure
  73. HoTMetaL PRO's File menu in either of two ways. 
  74.  
  75. * DMS-specific menu items: the File menu will contain
  76. two pairs of Save As and Open menu items: one pair for
  77. accessing the DMS and the second pair accessing the
  78. local file system
  79.  
  80. Or:
  81.  
  82. * Combined menu items: the File menu will contain only
  83. one Save As/Open menu item pair that can be used to
  84. access both the DMS and the local file system.
  85.  
  86. This is purely a convenience option; the functionality
  87. available to you is the same in either case.
  88.  
  89. 14.3.2.1. DMS-specific menu items
  90.  
  91. To obtain the first configuration above, make the following
  92. settings:
  93.  
  94. own_menu_items_for_dmsá=átrue
  95. dms_name_for_menu_itemsá=áDMSáName
  96.  
  97.  
  98. In this case:
  99.  
  100. 1.  A second Open menu item whose menu label has the
  101. form Open from [DMS]... will be added to the File menu
  102. underneath the existing Open... item. This will allow
  103. you to open documents from the DMS server. 
  104.  
  105. 2. A new toolbar button whose tooltip is Open from document
  106. server appears beside the default Open toolbar button.
  107. Clicking on this toolbar button has the same effect
  108. as choosing the Open from [DMS]... menu item.
  109.  
  110. 3. A second Save As menu item whose menu label has the
  111. form Save to [DMS] As... will be added to the File menu
  112. underneath the existing Save As... item. This will allow
  113. you to save documents to the DMS server. 
  114.  
  115. 4. If the document was last saved to, or read from,
  116. the DMS, then a plain Save will save the file to the
  117. DMS, and the command name will change temporarily to
  118. Save to [DMS] to remind you of this.
  119.  
  120. 5. The [DMS] part of these command names is configurable
  121. and gets its value from the dms_name_for_menu_items
  122. option in the configuration file. For example:
  123.  
  124. dms_name_for_menu_itemsá=áSesame
  125.  
  126.  
  127. would cause the menu items to appear as Open from Sesame...
  128. and Save to Sesame As....
  129.  
  130. 14.3.2.2. Combined menu items
  131.  
  132. To obtain the second configuration, set:
  133.  
  134. own_menu_items_for_dmsá=áfalseá
  135.  
  136.  
  137. In this case, the standard menu items will invoke DMS
  138. operations. Save As now means Save to DMS As and Open
  139. means Open from DMS (and so does the Open toolbar icon).
  140. When you save a document that hasn't been saved before,
  141. the dialog box that appears will be labeled Save to
  142. [DMS].
  143.  
  144. The dialog box produced by each of these menu items
  145. will have a button to enable access to the local filesystem.
  146. This button will produce the standard (non-DMS) HoTMetaL
  147. PRO version of the dialog box.
  148.  
  149. The Activate [server] menu item will still be found
  150. in the File menu.
  151.  
  152. 14.4. Autosaving 
  153.  
  154. If you set:
  155.  
  156. local_only_autosave_of_dms_fileá=átrue
  157.  
  158.  
  159. then only an explicit save command (or [Ctrl+S] or other
  160. equivalent) from you will cause the file to be saved
  161. to the DMS. The autosaves that are performed at certain
  162. times or after every so many changes will save to the
  163. local temporary file only.
  164.  
  165. If you set:
  166.  
  167. local_only_autosave_of_dms_fileá=áfalse
  168.  
  169.  
  170. then any autosave will go to the same destination as
  171. a manual save would.
  172.  
  173.